home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / misc / nenscript1_3.lha / nenscript.man < prev    next >
Text File  |  1993-03-22  |  8KB  |  264 lines
  1.  
  2.  
  3.  
  4.    20 August 1992                                                NENSCRIPT(1)
  5.  
  6.  
  7.  
  8.    NAME
  9.      nenscript - format an ASCII file and convert to PostScript
  10.  
  11.    SYNOPSIS
  12.      nenscript [ -?12BGghlNnRrsVWwZ ] [ -f_f_o_n_t ] [ -F_t_i_t_l_e_f_o_n_t ] [ -b_h_e_a_d_e_r ]
  13.      [ -i_f_i_l_e_t_i_t_l_e ] [ -L_l_i_n_e_s ] [ -p_f_i_l_e_n_a_m_e ] [ -P_p_r_i_n_t_e_r ] [ -S_c_l_a_s_s_i_f_i_c_a_-
  14.      _t_i_o_n ] [ -T_p_a_p_e_r_t_y_p_e ] [ -t_t_a_b_s_t_o_p_s ] [ -#_c_o_p_i_e_s ] [ _f_i_l_e... ]
  15.  
  16.    DESCRIPTION
  17.      Formats the specified ASCII files and produces PostScript output con-
  18.      forming to the Adobe Structuring Conventions.  The output pages may be
  19.      in landscape or portrait mode, with one or two columns, with or without
  20.      headers.
  21.  
  22.      If no input files are specified, then input is accepted from stdin.
  23.  
  24.      Tabs in the input stream are expanded (by default) to eight character
  25.      positions.
  26.  
  27.      Formfeed (control-L) characters in the input stream cause a new page or
  28.      column to be started. Form feed characters must be at the start start of
  29.      a line, or preceded only by whitespace.
  30.  
  31.      PostScript output is directed to a printer using lpr unless otherwise
  32.      specified using the -p option. The printer to use is set by the PRINTER
  33.      environment variable.  If this is not set, then the printer "Postscript"
  34.      ("prn" for MSDOS) will be used.
  35.  
  36.      Font specifications are formed from the font name and the font size,
  37.      i.e. Courier10 specifies a 10 point Courier font, and Courier-Bold12
  38.      specifies a bold, 12 point Courier font. Sizes can also be given with a
  39.      decimal point, i.e.  Courier7.5 specifies a 7.5 point font, this might
  40.      however result in a marginal error in the size calculations, since a
  41.      linear approximation of the character width is done.
  42.  
  43.      The NENSCRIPT environment variable may be used to set default values for
  44.      most configurable attributes. Values set in this way will be overridden
  45.      by any options specified on the commands line.
  46.  
  47.      The current version of nenscript is 1.13.
  48.  
  49.  
  50.    OPTIONS
  51.  
  52.      -?   -h Print usage message.
  53.  
  54.  
  55.      -1   Specifies single column output (default).
  56.  
  57.  
  58.      -2   Specifies two column output.
  59.  
  60.  
  61.  
  62.  
  63.                                                                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    NENSCRIPT(1)                                                20 August 1992
  71.  
  72.  
  73.      -B   Turns off page titles.
  74.  
  75.  
  76.      -b_h_e_a_d_e_r
  77.           Print the text specified by _h_e_a_d_e_r as the title on each page,
  78.           rather than the default header which is composed of the name of the
  79.           source file, the current time and date and the page number. If in
  80.           gaudy mode, the title is displayed in the blank area just above the
  81.           file title.
  82.  
  83.  
  84.      -f_f_o_n_t
  85.           Use _f_o_n_t for printing text. Only Courier in sizes 5 to 30 can be
  86.           used for printing text. The default font is Courier10, unless two
  87.           column landscape mode is specified in which case the default font
  88.           is Courier7.
  89.  
  90.  
  91.      -F_t_i_t_l_e_f_o_n_t
  92.           Use _t_i_t_l_e_f_o_n_t for printing titles. Any font in any point size can
  93.           be used for printing titles.The default font is Courier-Bold10.
  94.  
  95.  
  96.      -G   Enable gaudy mode.
  97.  
  98.  
  99.      -g   Disable gaudy mode (default).
  100.  
  101.  
  102.      -i_f_i_l_e_t_i_t_l_e
  103.           Use the specified string as the displayed filename. Useful when
  104.           inputting from stdin.
  105.  
  106.  
  107.      -L_l_i_n_e_s
  108.           Set the maximum number of lines which will be printed per page or
  109.           column. The actual number of lines which appear may be less depend-
  110.           ing upon the font and paper size.
  111.  
  112.  
  113.      -l   Do not set a limit on on the maximum number of lines per page, i.e.
  114.           the number of lines is determined by the font size and the paper
  115.           size (default).
  116.  
  117.  
  118.      -N   Precede each line with it's line number relative to the start of
  119.           the file.
  120.  
  121.  
  122.      -n   Disable line numbering (default).
  123.  
  124.  
  125.      -p_f_i_l_e_n_a_m_e
  126.           Direct the PostScript to _f_i_l_e_n_a_m_e rather than the default printer.
  127.  
  128.  
  129.    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.    20 August 1992                                                NENSCRIPT(1)
  137.  
  138.  
  139.           If '-' is specified as the filename, then the PostScript is sent to
  140.           stdout.
  141.  
  142.  
  143.      -P_p_r_i_n_t_e_r
  144.           Overrides the PRINTER environment variable in determining the
  145.           printer to spool output to. Ignored if -p is used.
  146.  
  147.  
  148.      -R   Don't rotate the page, i.e. output in portrait mode (default).
  149.  
  150.  
  151.      -r   Rotate the page, i.e. output in landscape mode.
  152.  
  153.  
  154.      -S_c_l_a_s_s_i_f_i_c_a_t_i_o_n
  155.           Prints the string argument in Helvetica-Bold28 at the top and bot-
  156.           tom of the page in conformance to regulations for printing classi-
  157.           fied material.
  158.  
  159.  
  160.      -s   Disable a previous heading specified with the -S option.
  161.  
  162.  
  163.      -T_p_a_p_e_r_t_y_p_e
  164.           Sets the output paper type as per the argument. At the moment, only
  165.           two paper types are supported: A4 and US. The default paper size
  166.           will be A4, unless the US_VERSION define is specified at compila-
  167.           tion time.
  168.  
  169.  
  170.      -t_t_a_b_s_i_z_e
  171.           Sets the number of columns to which tabs are expanded. The default
  172.           is eight columns.
  173.  
  174.  
  175.      -V   Display information identifying the version of nenscript. Nothing
  176.           will be printed regardless
  177.  
  178.  
  179.      -W   Truncate lines which are wide for the page.
  180.  
  181.  
  182.      -w   Wrap lines which are too wide for the page onto successive lines
  183.           (default).  Continuation lines are marked with + character before
  184.           the left margin.
  185.  
  186.  
  187.      -Z   Check the first two characters of the input for the character
  188.           string %!. If a match is found, the input is copied directly to the
  189.           output with no processing.
  190.  
  191.  
  192.      -#_c_o_p_i_e_s
  193.  
  194.  
  195.                                                                             3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.    NENSCRIPT(1)                                                20 August 1992
  203.  
  204.  
  205.           Print each page _c_o_p_i_e_s times.
  206.  
  207.  
  208.    ENVIRONMENT
  209.  
  210.    set, the default is a printer named "PostScript".
  211.      Specifies the name of the printer to direct PostScript output to. If not
  212.  
  213.  
  214.    line supplied by the user.
  215.      If defined, this string is searched for valid options before the command
  216.  
  217.  
  218.    BUGS
  219.  
  220.      As nenscript does not have access to complete PostScript font tables, it
  221.      must use some other technique for calculating the number of characters
  222.      that fit across the page. The solution was to use a fixed table for the
  223.      Courier font in a range of sizes. If this table was extended, other
  224.      fonts and sizes could be used for printing text. Alternatively, if the
  225.      text processing was done on the printer, then there would be no need to
  226.      know anything about the font sizes...
  227.  
  228.      No checking is performed on font names, other than checking that only
  229.      Courier can be specified for the text font. If a font is specified that
  230.      is not available on the final printer, the result is undetermined.
  231.  
  232.      No checking is performed on the input file to detect accidental printing
  233.      of garbage files. Caveat emptor!
  234.  
  235.      No mapping of the input characters is performed, so output may vary
  236.      depending upon the vagaries of downstream software and hardware.
  237.  
  238.      No support for manual feed, page prefeed, mail upon completion or any of
  239.      the other rarely used options of enscript.
  240.  
  241.      No messages are displayed whilst processing.
  242.  
  243.      Input line lengths are limited to 8192 characters after expansion of
  244.      tabs.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.    4
  262.  
  263.